Framework (
A-Z)
Reference for Wiring version 1.0 Build 0100+ If you have a previous version, use the reference included with your software. If see any errors or have any comments, let us know.
Name |
Vector |
Examples |
Vector < int > intVector;
void setup() {
Serial.begin(9600);
pinMode(WLED, OUTPUT);
digitalWrite(WLED, HIGH);
for (int i=0; i<255; i++) {
intVector.addElement(i);
}
Serial.print("The vector's capacity is: ");
Serial.println(intVector.capacity(), DEC);
if (intVector.contains(15) == true) {
Serial.println("The vector contains the element 15");
}
Serial.print("The vector's first element is: ");
Serial.println(intVector.firstElement(), DEC);
Serial.print("The vector's index for element 30 is: ");
Serial.println(intVector.indexOf(30), DEC);
if (intVector.isEmpty() == false) {
Serial.println("The vector has elements");
}
Serial.print("The vector's last element is: ");
Serial.println(intVector.lastElement(), DEC);
Serial.print("The vector's last index of 10 is: ");
Serial.println(intVector.lastIndexOf(10), DEC);
Serial.print("The vector's size is: ");
Serial.println(intVector.size(), DEC);
if (intVector.add(255) == true) {
Serial.print("the element was added and now the vector's last element is: ");
Serial.println(intVector.lastElement(), DEC);
}
intVector.addElement(256);
Serial.print("now the vector's last element is: ");
Serial.println(intVector.lastElement(), DEC);
intVector.insertElementAt(0, 10);
int t = intVector.elementAt(10);
Serial.print("t is: ");
Serial.println(t, DEC);
intVector.remove(10);
t = intVector.get(10);
Serial.print("t after remove is: ");
Serial.println(t, DEC);
intVector.removeElementAt(10);
t = intVector.get(10);
Serial.print("t after removeElementAt is: ");
Serial.println(t, DEC);
if (intVector.removeElement(23)==true) {
Serial.println("the element 23 was removed.");
}
intVector.setElementAt(10, 5);
t = intVector.get(5);
Serial.print("element at index 5 is now: ");
Serial.println(t, DEC);
intVector.clear();
Serial.print("The vector's size after clear is: ");
Serial.println(intVector.size(), DEC);
}
void loop() {
}
|
Description |
A vector is a growable array of elements. Like an array, it contains components that can be accessed using an integer index. However, the size of a Vector can grow or shrink as needed to accommodate adding and removing items after the Vector has been created. The class Vector includes methods for examining individual elements, comparing, searching and extracting parts.
Note that the Wiring Vector class has differences with the processing or Java Vector class. The main difference is that some methods modify the actual vector instead of returning a modified copy of it and it can only hold simple types of elements: int, long or char. |
Fields |
|
Methods |
capacity() |
Returns the current capacity of this vector |
contains() |
Tests if the specified element is a component in this vector |
firstElement() |
Returns the first element (the item at index 0) of this vector |
indexOf() |
Searches for the first occurence of the given element |
isEmpty() |
Tests if this vector has no elements |
lastElement() |
Returns the last element of the vector |
lastIndexOf() |
Returns the index value of the last occurrence of an element within the input element |
size() |
Returns the number of elements in this vector |
count() |
Returns the number of elements in this vector, (same as size) |
copyInto() |
Copies the components of this vector into the specified array |
add() |
Appends the specified element to the end of this vector |
addElement() |
Adds the specified element to the end of this vector, increasing its size by one |
clear() |
Removes all of the elements from this vector |
ensureCapacity() |
Increases the capacity of this vector, if necessary, to ensure that it can hold at least the number of components specified by the minimum capacity argument |
removeAllElements() |
Removes all elements from this vector and sets its size to zero |
setSize() |
Sets the size of this vector |
trimToSize() |
Trims the capacity of this vector to be the vector's current size |
elementAt() |
Returns the component at the specified index |
insertElementAt() |
Inserts the specified element as a component in this vector at the specified index |
remove() |
Removes the element at the specified position in this vector |
removeElementAt() |
Deletes the element at the specified index |
setElementAt() |
Sets the component at the specified index of this vector to be the specified element |
get() |
Returns the element at the specified position in this Vector |
|
Constructor |
Vector <datatype> variable
Vector()
Vector(data)
Vector(initialCapacity)
Vector(initialCapacity, capacityIncrement) |
Parameters |
datatype |
datatype: the type of elements the array can hold: int, long, char etc. |
data |
Vector: vector to be copied into the created vector |
initialCapacity |
the vector's specified initial capacity |
capacityIncrement |
the vector's specified initial capacity increment |
|
Usage |
Application |
Updated on July 07, 2011 11:09:20pm PDT